home *** CD-ROM | disk | FTP | other *** search
/ Aminet 33 / Aminet 33 - October 1999.iso / Aminet / util / misc / HunkReader.lha / HunkReader / HunkReader.doc < prev    next >
Encoding:
Text File  |  1999-08-27  |  4.6 KB  |  126 lines
  1.  
  2.              HunkReader is Copyright © 1997-1999 Andrew Bell.
  3.  
  4.                       This is version, 1.4 (27.8.99)
  5.  
  6.     (If you don't know what a hunk, segment, reloc table, etc. is then
  7.                    you souldn't be using this program :)
  8.  
  9.   ----------------------------------------------------------------------
  10.                                 DISCLAIMER
  11.   ----------------------------------------------------------------------
  12.  
  13.    THIS SOFTWARE IS PROVIDED "AS IS",  NO WARRENTY IS GIVEN,  EXPRESSED
  14.    OR IMPLIED.  BY USING  THIS SOFTWARE,  YOU ARE  RESPONSIBLE  FOR ANY
  15.    DAMAGES THAT  OCCUR DIRECTLY OR  INDIRECTLY AS A RESULT FROM THE USE
  16.    OR MISUSE OF IT.
  17.  
  18.   ----------------------------------------------------------------------
  19.                                    LEGAL
  20.   ----------------------------------------------------------------------
  21.  
  22.   HunkReader (HR) and all related files are Copyright © 1999 Andrew Bell.
  23.                            All rights reserved.
  24.  
  25.                    HR may be distributed free of charge.
  26.  
  27.    HR may be distributed via any form, as long as no profit is ask for.
  28.  
  29.              When distributing all files must remain together.
  30.  
  31.   ----------------------------------------------------------------------
  32.                                INTRODUCTION
  33.   ----------------------------------------------------------------------
  34.  
  35.     HR is EMAILWARE, if you use it often, then please send the author a
  36.    e-mail, I'd like get get a rough idea of how many people are using it
  37.                                   thanks.
  38.  
  39.                        (my e-mail address is below).
  40.  
  41.  HR is a program that views the hunk structure of executable files. Don't
  42.   use it on link libs (about 15% of linklib hunks are not supported), not
  43.     all HUNK_EXTs are supported. HR does not like overlayed files much.
  44.  
  45.   This program might be useful to thoses of you who write utilities that
  46.                         procedure executable files.
  47.  
  48.   ----------------------------------------------------------------------
  49.                                INSTALLATION
  50.   ----------------------------------------------------------------------
  51.  
  52.                  Copy the HR executable to the C: drawer.
  53.  
  54.   ----------------------------------------------------------------------
  55.                                    USAGE
  56.   ----------------------------------------------------------------------
  57.  
  58.     This program can only be used from Shell or CLI. To start it, open
  59.   your Shell window out wide and type HR <filename>. Where <filename> is,
  60.      is the location of the executable file that you want to examine.
  61.  
  62.   ----------------------------------------------------------------------
  63.                                 PARAMETERS
  64.   ----------------------------------------------------------------------
  65.  
  66.                      Quick overview of the parameters:
  67.  
  68.   FILE/A  = Name of executable file to dump.
  69.   DSYM/S  = Display symbol blocks.
  70.   DREL/S  = Display relocs (Handy for making exes smaller!).
  71.   DEXT/S  = Display HUNK_EXTs (Unfinished).
  72.   STATS/S = Display some information about the file that has just been
  73.         processed.
  74.  
  75.    Don't use the DREL/S parameter on very large files. For example, the
  76.   MAME executable has more than 165000 relocs! The file itself, is about
  77.     4MB, 600K of that is used by HUNK_RELOC32 entries. I feal sorry for
  78.                          dos.library/LoadSeg() :-)
  79.  
  80.   ----------------------------------------------------------------------
  81.                                   HISTORY
  82.   ----------------------------------------------------------------------
  83.  
  84.  
  85.   1.0 - (17.11.97)
  86.  
  87.    o First working version.
  88.  
  89.   1.1 - (17.12.97)
  90.  
  91.    o STATS options now displays total allocation size.
  92.  
  93.   1.2 - (10.8.98)
  94.  
  95.    o Clean up source code.
  96.    o Full proto checking.
  97.    o Added inline calls.
  98.    o Fixed a bug comcerning VPrintf()
  99.    o Cleaned up data types. Uses #defines for internal dates.
  100.    o Internal version tag is now static.
  101.    o Fixed a bug concerning HUNK_RELOC32SHORTs.
  102.  
  103.   1.3 - (27.3.99)
  104.  
  105.    o Some things cleaned up & minor changes.
  106.    o First public release via website (beta version).
  107.  
  108.   1.4 - (27.8.99)
  109.  
  110.    o Ported to the Hisoft C++ compiler.
  111.    o Source code cleaned up.
  112.    o Added buffered IO routines.
  113.    o Replaced VPrintf() calls with Printf().
  114.  
  115.   ----------------------------------------------------------------------
  116.                                   AUTHOR
  117.   ----------------------------------------------------------------------
  118.  
  119.                                 Andrew Bell
  120.  
  121.                      Please contact me via e-mail at:
  122.  
  123.                          andrew.ab2000@bigfoot.com
  124.                                     or
  125.                         andrew@ab2000.prestel.co.uk
  126.